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Reading AppleWorics data bases 

While a few of you are still hold outs, most folks in the Apple II kingdom 
have become very fond of AppleWorks in general and of the AppleWarks data 
base in particular. The great strength of the AppleWorks data base is speed. It 
sorts and retrieves data fast enough to make mainframes blush. Data entry 
and editing is smooth and quick. 

The amount of data that will fit in one record, of course, is limited to 30 
different categories and what will fit on a single screen. The number of 
records that will fit in a single file depends only on what version of which 
company's RAMcard expansion software you have. 

For getting the data in your file out onto paper, AppleWorks allows you to 
define eight report formats. While these formats are sufficient for many types 
of reports, they pose significant limits for others. 

You can't for example, dump your AppleWorks data onto a pre-printed 
form if more than 15 lines separate the highest and lowest areas you must fill 
out If you use the AppleWorks data base to fill out continuous credit card 
forms (as we do around here), you have to include your company name and 
merchant number in every record; there's no other way to tell AppleWorks to 
print the same thing— even so much as a comma between cfty and state- 
on every form. 

There are a few fairly easy solutions to these problems. The mail merge 
features of Autolibrfcs and of the new AppleWorks 2.0 will solve both of the 
problems I've just mentioned. Another possibility is to open-apple-Pfrint) 
your data base into a file, then read that file with your own program and 
manipulate the data any way you like. You could even update the data (for 
example, deduct today's sales from your toy store's inventory) and store the 
updated data in a DIF file. The DIF file could be loaded into AppleWorks as a 
new data base. The records in that new data base could be copied, using the 
clipboard, into the old data base and the old records deleted. This process is 
cumbersome, however, and not without some ill effects, such as the 
disappearance of hyphens from phone numbers and the inability to 
chronologically sort time and date categories. 

Another way to solve all these problems is to figure out how to have your 
own program directly read AppleWorks data base flies. Those of you who are 
programmers probably realize that if you could get into the file itself you 
could manipulate and print out the data any way you wanted . You could even 
update the data and store a new AppleVforks-format data base file on disk. 
The possibilities are so immense that readers have been asking me to 
explain how to do it since I was struggling with volume 1 

I've been reluctant to try, however. There's no straightforward way to read an 
AppleWorks data base file with Applesoft in PUT or GET commands. This 
leaves loading the file into memory and reading it with assembly language 
subroutines or with Applesoft PEEK loops. The problem with assembly 
language routines is that they take a long time to write and test and they are 
usually too long to publish. The problem with PEEK loops is that they are 
excruciatingly slow. For example, consider this little program: 



10 HGR 

20 FOR C = 1 TD A 
30 POKE 8192, C*5B 
40 NEXT 
50 TEXT 



FDR I - 6193 TD 16383 : POKE I, PEEK 1-1 : NEXT 



About all the program does is 32,768 POKEs and 32,767 PEEKs. Because it 
does them in the memory area devoted to the hi-res screen, with hi-res 
graphics turned on, it also displays some really ugly patterns. Under 
standard Applesoft the program takes more than three minutes to execute 



(190 seconds to be exact). On a Jigs running in fast mode you get a boost 
factor of Z7 — 71 seconds total — still not very fast 

While pondering these problems (after receiving the latest request for 
information on how to read an AppleWorks data base file), I remembered 
reading in the thin (but excellent) little manual that comes with the Beagle 
Compiler that compiled programs should use integer values whenever they 
can, because integers execute much faster than floating point values (the 
compiler considers an integer to be any whole number between -32767 and 
32767, whether stored in an integer variable, such as 1%, or not). I wondered 
whether the compilerwould speed up PEEK and POKE loops, which usesuch 
integer values. I compiled the above program and tested it Running on a 
normal Apple II, the program finished in IS seconds— 10 times raster than 
normal. On a llgs running in fast mode, the time was further cut to less than 8 
seconds, which is 24 times faster than what we started with a paragraph ago 
and plenty fast enough to read a data base file. 

So thismonth I'm doing it Here's howto read an AppleWorks data base file. 
Well save writing a new one for a later issue. 

File structure. The first thing you need to know is that AppleWorks data 
base files have three main parts. The first part is called the header. Among the 
goodies you can dig out of the header are the number of records in the file, 
the number of categories per record and their names, and the number of 
report formats that have been defined. There's also a bunch of other stuff 
there thaf s important to AppleWorks but of little use to us, such as the fo rmat 
of the single-record and multiple-record screens and the current record 
selection rules. 
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The header itself can be split into two parts. The second part holds the 
names of the categories. The first part holds everything else. The first part is 
357 bytes long. The second part has 22 bytes for each category that has been 
defined. If all of the 30 possible categories have been assigned names, the 
second part is 22 • 30 or 660 bytes long, for a total length of 1017 bytes. The 
header can never be longer than this. 

(The only advantage to having data base hies with less than 30 defined 
categories is that you save 22 bytes of file and desktop space per category 
not defined. The disadvantage, of course, is that should you ever need to add 
a category to a file, your report formats will be deleted. It's Far better, in the 
world of today's expanded desktops, to always assign 30 categories to new 
files, name the ones you have no current use for something like "+", and use 
open-apple-Lfayout) to move them to a comer of the screen.) 

So much for the header. The second section of an AppleWorks data base 
file holds the report formats. Each report format uses 600 bytes. Thus, the 
length of this section can vary from nothing at all, if no formats have been 
defined, to 4,800 bytes if the maximum of eight formats has been defined. 

The third section of an AppleWorks data base file holds the actual data 
records. Records appear in the order in which you last sorted them, (Except 
that the first record always holds the file's "standard values.") Within each 
record, categories appear in the order in which they were defined with open- 
apple-M(ame), which is also the order in which the category names appear at 
the end of the header section. 

Reading a category. The record-category data is all scrunched together. 
This part of the file Is similar to a sequential text file rather than being spread 
out in equal-length, mostly-empty segments as are random-access text files. 

The first two bytes of each record indicate how long the rest of the record is. 
Mext comes the data for the first category. The first byte of each category is a 
"control byte," When this number is less than 128, it indicates how many 
bytes of data follow. Let's assume we have a variable called PltTR that points 
to the current control byte, The following subroutine will dig the data out of 
that control byte's category and store it in a string variable called C$(M): 

5180 REM read a single category's data into Cl(N) 

5112 CBYTE = PEEK(PNTR), : PNTR=PNTR+1 : REM Get control byta, . 
51G2 CU~' : FDR I-PNTR TO PNTR4CBYTE1 : C? - Ct + CHRf(PEEK(T) ) : NEXT 
5198 Ct(N)=C* : PNTR=PNTR+ CBYTE : UEP1 Stance pointer to naxt cattgory. 
5195 RETURN 

Line 5162 holds what I mean by a "PECK loop." It begins by clearing a 
variable called C$, which will temporarily hold the category's data. Then it 
loops the number of times required to dig the data out of memory. The 
PEEKU) part of CHR$(PEEK{1)) tells us what value is at byte I, then the CHR$ 
part immediately converts that value into an ASCII character. 

You may find tine 5162s TO FTiTR+CBYTE-l" puzzling. We have to 
subtract 1 from CBYTE because of the old "indexed from zero'' paradox. If 
PTiTR is at byte 100, and CBYTE says there are ten bytes of data, they would be 
stored in bytes 100 through 109. Looking in bytes 100 through 110 would 
return eleven bytes ofdata-Aclearerwaytowrite the statement might be FOR 
1=1 TO CBYTE : C$=C$ + CHR$(PEEK(PrfTR+l-l)). Writing it like that would 
slow down execution, however, because of the additional calculations Inside 
the PEEK statement that would have to be done on each pass through the 
loop. 

flow suppose that the value in CBYTE is greater than 128. If CBYTE is 129, it 
means the next category is blank If CBYTE is 130, it means the next two 
categories are blank. In other words, CBYTE-128 gives you the number of 
categories to skip. If CBYTE is 255, it means all remaining categories are 
blank and you have reached the end of the record. If mere are no blank 
categories at the end of the record, there will still be a 255 marker. 

For example, a completely blank record takes up three bytes of space, no 
matter how many categories there are. The first two bytes indicate the 
number of bytes in the rest of the record (1— $01 $00 in hex) and the final 
byte is a 255, indicating all remaining categories are blank. A record with 30 
categories, all blank but the last would begin with two length bytes, then have 
a control byte of 157 (128 + 29), followed by a control byte indicating the 
length of the data in category 30, followed by that data, followed by a record- 
ending control byte holding 255. 

Let's add some lines to our previous subroutine to handle blank 
categories, "TiB" is a variable that keeps track of the number of blank 
categories that should be skipped: 

5188 REM read a single category's data into C»(N] 

5118 IF NB > « THEN 51B4 : REM In the diddle of multiple blanks? 

5112 CBYTE = PEEK(PNTR) : PNTRsPNTR+1 : REM Get control byte. 

5114 IF CBYTE > 127 THEN 51BB ; REM Start multiple blank categoriss. 



5168 REM Category contains RSCII-strlng data. 

5162 C*i" : FOB I*PNTR TO PNTB+CBYTE-1 : Ci = Ct - CnRS [ PEEK 1 1 ) ) : NEXT 
5164 GOTO 5198 

51B8 REM Category Is blank. 

51B2 NB=CBYTE- 12B : REM CHYTE-IS2 :s 6 cf blank categoric. 

51B4 M [N)=" : NB=NB-1 : GOTO 5195 

5198 II[N]=CI : Z NT£=PNTR+CBYTE : REff Advance ao.--.a- to rent category. 
5195 RETURN 

One other detail we probably ought to consider comes up with categories 
that hold dates or times. AppleWorks uses a special storage format for dates 
and times to make them easier to sort The first byte of a date category is 192 
($C0). The first byte of a time category is 212 ($D4). The first byte of any other 
kind ol category is a low-value ASCII character, which will be less than 128. 

Date entries consist of six bytes. The firs! is the ID byte i 192 or SCO). The 
next two hold the year in ASCII characters. The next holds the month, where 
an ASCII "A" means January, "B" means February, and so on up to "L" for 
December. The last two bytes hold an ASCII dayof-month. 

Ti me entries consist of four bytes. The first in the ID byte (212 or $D4). The 
next byte indicates the hour. An ASCII "A" means 00 (the hour after 
midnight), "B" means GL and so on up to "X" or 23 (the hour before 
midnight). By adding the following lines to our previous subroutine, we can 
add the capability of reactingcak-v 

103B DIM MDI(12) : HEM This array is for the nams of the mnths. 
1B4B POJ (l)^'Jan- : WW (2)=Teb* : MDI [3)-"H«r" 
1842 MOJ (4)="Apr- : "™ [5]="Kay" : MDI [8]»Mun" 
1844 MOS (7)--Ju|- : MDI [B]«-flug* : MQS [SJ-'Sep" 
1846 M0J(19)="0ct- : raf[ll]=-Nov- : B0«[12]«Tlie- 

5116 T=PEEK(PNTR] : IF T<12B THEN 5168 : REM Date or time category? 
5UB [F T=212 THEN 5138 

5128 REM Category contains a date. 

5122 YR* - CHR$(PEEK(PNTRtl)) + CHRS(PEEK(PNTR+2) ) 

5124 MM = M0I(PEEK(PNTR+3)-64) 

512B Off = CHRl(PEEK(PNTR+4)) + CHRt(PEEK[PNTR*5)J 

5128 « - M0I + ' ' + DYI + " " + YR» : GOTO 5198 

513* REM Category contains a time. 

5132 m - "SM- : HR = (PEEK(PNTR+1 ) - G5) 

5134 IF HS > 11' THEN fIS = "HI" : IF HR > 12 TSCN HR = HR-12 

5136 HRE = 5TRJ|HR] : IF HR < 10 THEN HRI - '8' * HRt 

513B MIS = CHB»(PEEK(PNTR*2)| + CHRS|PEEK(PMTR+3) ( 

5148 C* - HRS + ":" + MIS GOTO 5198 

Line 5124 takes advantage of the fact that the ASCII codes for letters are 
sequential numbers. It rums the "A" that means January, for example, into a 
"1" by subtracting 64 from the ASCII code for "A" (65 or $41). B" becomes a 
"2," and so on. The resulting value (1 to 12) pulls a month abbreviation out of 
the previously-defined array MO$(N). 

Likewise, in line 5132, the letter codes for the hours are turned into 
numbers between zero and 23 by subtracting 65 from the ASCI! letter code. 
As written, these routines convert dates and times to strings that look exactly 
like what AppleWorks itself displays. With slight modifications you could 
arrange dates or times into any alternative formatyou might prefer. 

Reading a record. Mow that we havea routine thatreads categories, it isa 
simple matter to write a routine that reads whole records. The following 
subroutine assumes only that PflTR points at the correct byte of the file and 
that the number of categories for the file has previously been placed in the 
variable NC. It also checks for the presence of the end of record marker and 
jumps to an error routine at line 5900 if it is missing. Since any error is quite 
likely a program error rather than a file error, the error routine prints some 
he Ipful debugging information (this particular program, of course, has been 
tested thoroughly and woiked fine, of course, just before I sent it to the 
typesetter, of course— I include these lines, of course, in case your own 
program, of course, based on this one, of course, requires some fine-toning, 
of course): 

5880 HEM read record's catsgories Into C*(1)...C«(N) 

5818 RL - FN PK2(PNTR) : PNTR = PNTR+2 : REM RL Is Record's Length 

5838 NB-8 ; REM inlt II of blanks to 

5948 FDR N=8 TO NC-1 : EOSUB 5188 : NEXT : REM get category data 

S8S8 GOSUB 5180 : IF CBYTE < > 255 THEN 5588 : REM get tFF at end of record 

58fi8 RETURN 
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5988 REM The file doesn't look right--prooaoly a prognM, not a file, bug. 
S91B HQP1E : VTRB 10 

5928 PRINT I've encountered an error In the file's structure" 
5930 PRINT " In record -;H;" and category ~;N;"." 
S940 PRINT 

S3-» ?RIN- ""he His buffer begins at ";66G;" and ends a-. ";BEN;~-" 
59£0 PRINT ' The buffer pointer is at BytB ";PNTR;*\~ 
5990 END 

The "FN PK2(FT1TR)" in line 5010 is a function that does a two-byte PEEK. 
The function is defined earlier in the program but later in this article. For 
more information on this trick see page 2.35 in our June 1986 issue. 

Memory buffers. Everything we've talked about so far assumes that 
somehow we've loaded at least a part of the AppleWorks data base file into 
memory and that the variable PT1TR points to the proper byte within the fi le. In 
order to do this we have to take care to set aside a block of memory we can 
use as a "buffer" and see to It that Applesoft doesn t accidentally try to use 
the same memory area. We also want this memory area to lie in an address 
range less than 32768 ($8000) so that a compiled version of our program 
can PEEK with integers and run at maximum speed. One good place to put 
the buffer is between the Applesoft program and its variable tables. 

Figure 1 is a picture of how Applesoft uses your Apple's memory. Normally, 
Applesoft builds the variable tables adjacent to the end of the program 
image. By proper use of the LOMEM: command, however, we can move the 
variable tables and create an area of free space between the program image 
and the tables. This has to be done at the beginning of the program, however, 
before any variables have been used. (And in order to work with the Beagie 
Compiler, which doesn't update the PRGEflD — program end— pointer at 
bytes 175-176 quite right it has to be done without referring to PROEMD.) 
How about 

1008 REH Program initialization 

1310 LOMEM: 1G384 + PEEKJ185) * PEEK(10S)*259 : REM Create lS3B4-bute buffer. 

1030 0EF FN PK2(H0R) = PEEK(RDR) ♦ PEEK(fl0R+l)«256 i REM 2-byte peak function. 

1832 DIM OBJ30) : REM This array is for category names. 

1834 DIB CS[38) : REM This array is for the lnforMtitm in categories. 

1050 BBG = FN PK2(105)-1E3B4 : REM BBG pointa to the beginning of our buffer. 

1852 BEN = BBG + 1E3B4/2 : REM BEN points to the end of our buffer. 

105<t PNTR = BBG : REM PNTR paints to our position ir, :he buffer. 

L05G B'rTE=0 : REM BYTE points to our position in the file. 
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The PEEKs in line 1010 look up the current location of the variable tables; 
LOMEM: and the addition of 16384 move them $4000 bytes away from the 

dimension some arrays we'll need later. lines 1050 to 1056 set up some 
pointers to the beginning and end of our buffer and to our position in the 
buffer and in the file on disk. In line 1052 we actually divide the $4000 bytes 
we have set aside into two buffers— only one will actually be used in this 
program, but we'll need the other in a couple of months when we give this 
program the ability to write AppleWorks files, too. 

One of the beauties of FroDOS is the ease with which any type of file can be 
loaded into memory, even in small pieces. The upcoming subroutine for 
loading sections of AppleWorks data base files uses the BLOAD command, 
the A(ddress) and Uength) parameters that DOS 3.3 programmers are 
familiar with, and the T(ype) and B(yte) parameters that can only be used with 
FroDOS. 

The T(ype) parameter allows any type of file to be BLOADed. BLOAD is not 
restricted to binary files, as with DOS 3.3. Here, the file type we want to load is 
"ADB" 

The B(yte) parameter allows you to begin loading a file into memory at 
some position other than the beginning of the file. Setting B to 1000, for 
example, will cause the BLOAD to skip the first 1000 bytes of the file. This 
capability is absolutely necessary— without it you can't access files that are 
larger than the buffer. With it on the other hand, you can load the file into the 
buffer in pieces, Here's our subroutine: 

5500 REM load section of file into buffer 
5510 BtTE=BtTE+(PNTR-BBG) : PNTR=8BG 

5520 PRINT CHRS(4);"BL0RD";FI;\ TftDB. LB132. fl-;BBG;\ B";BVTE 
5538 RETURN 

Line 5510 calculates a value for the B(yte} parameter by determining the 
distance between our pointer, PNTR, and the beginning of the buffer. Then it 
adds that difference to the previous D(yte) value. When we initially load the 
first section of the file, these variables will cancel each other out and equal 
zero, so well begin BLOADing at byte zero. Later BLOADs will essentially 
move the byte that FHTR is pointing at from the end of the buffer to the 
beginning of the buffer. 

Somewhere we need to check to see if FHTR is nearing the end of the buffer. 
A good place to do this is right after line 5010, where we find out the length of 
the record we are about to read. Ws need only add the record length to the 
PNTR arid see if the result is beyond the end of the buffer. If so, we should 
reload the Hie. This line will take care of all that 

5628 IF PNTR+RL => BEN THEN G05UB 5508 : REM Does record extend beyond buffer? 

The header. After we have the beginning of the AppleWorks data base file 
BLOADed into our memory buffer and before we start reading the actual data 
embedded in the records, its necessary to dig a few important pieces of 
information out of the header. The header length is stored in the first two 
bytes of the file. This length does not include the two length bytes 
themselves, however, so we need to add two to the result to arrive at the full 
header length. 

The number of records in the file is a two-byte number and can be found at 
bytes 36 and 37 (where the first byte of the file is byte 0). The number of 
categories in the file is stored at byte 35. The number of report formats is 
stored at byte 38. And the category names are stored in 22-byte segments 
beginning at byte 357. Each name begins with a length byte and is followed by 
up to 21 ASCII characters. Here's the instructions for digging all this 
information out of the header; 

1188 REM Lead first section of file and dig stuff out of the haadar. 
1110 G05UB 5598 : REM load file 



1120 HL = fN PK2(PNTR]+2 : IF HL > 1017 THEN 5388 
1122 NR - FN PK2(PNTR+36) 

1124 NC = PEEK(PNTR+35) : IF NC > 30. THEN 5389 
1126 HF - PEEK(PNTR+3B) : If Nf > B THEN 5980 

1140 PNTR=PNTC»357 
1142 FDR N' » to MC-1 
1144 Ct="" : FDR 1=1 TD PEEK(PNTR) 
1146 CN1(N! = CJ : PNTR • PNTR+22 
1148 NEXT 

If you modify or amplify this program and you are pressed for space, you 
can make the buffer smaller. Don't make it smaller than IK (1024 bytes), 
however, or you might not be abl e to read the whole header in one chunk. Its 
also possible, though unlikely, that a single record could hold slightly more 



REM header length 
REM B of records in file 
REM II of categories 
REM 8 of report formats 

Rem get category names 

CI = CI + CHRJ(PEEK(PNTR+I)1 : NEK" 



3J2 Open-Apple 



Vol. 3, Ho. 2 



than IK of data, so a 125K buffer is probably a safer minimum size. To make 
the buffer smaller, change "16384" in lines 1010, 1050, and 1052 and "8192" 
in line 5520. 

After you've finished reading the header, PNTR will point to the first byte 
after the header. The next section of the file holds report formats, which we 
want to skip over completely. The following lines will do that 

lise PNTR - PNTR + NF*G88 : REM S ! <ip ovir 688 -byte -each report formats. 
1152 IF PNTR => BEN THEN nDSUB 5589 ; REM Oo formats extend bsyond buffer? 

That pretty much takes care of reading AppleVforks data base files. You 
now have everything you need to read such a file from an Applesoft program. 
Here are some additional program lines, however, that dress-up this demo a 
little so that you can easily read any AppleWorks data base file without 
actually running AppleWorks. 

CflUTlDN: THIS PORTION DF THE PROGRAM DOESN'T INCLUDE IHE PROGRAM LINES 
ENEE00E0 IN THE ACCOMPANYING ARTICLE . W.Cr ALSO MUST BE TYPED IN 
TO MPKE THE PROGRAM RUN. THE ORDER IN WHICH YOU TYPE THE LINES 
MAKES NO DIFFERENCE, JUST DON'T SKF n 3NY, DON'T ENTER LINES 10 THROUGH 58. 

100 REM *«* Open-Apple's HOB Reader *« 

101 REM btf Toffl Weishaar, Feb 19B7 

1029 CLEAR : REM Restart point For reading another file. 

1036 DIM TB(30,2) : REM This array is for category TAB positions on Bcrssn. 

1868 PRINT CHRJ[4);"PR!t3- : PRINT : REM B0-eolumn screen required. 
1062 VTAB 10 

1064 PRINT "What is the name oF the ApplsUnrks database file you uant in bbs?" 
1066 PRINT 

10SB INPUT FI : HOME 
1070 IF rU" THEN END 



113B FDR H = 9 TD NC-1 : REM Get screen positions. 

1132 TB(N,0) = PEEK(PNTR+ia6-tNl : REM screen sequence left-top to right-but 

1134 TB(N,1] = PEEKIPNTR+114+N) : REM horizontal screen position 

1136 TB(N,2) = PEEK|PNTR+158tN) : REM vertical screen position 

113B NEXT 

1160 REM Just for fun, drau an ApplsWarks-like screen for display. 

1167; r-RlNl "F;Le: ";RlGHTt[Ft,20) : PRINT ; PRINT 'Selsction: =111 -acords- 

1164 VTAB 1 : POKE 1493, 2B : PRINT "Open- Apple's AOB. READER" 

1166 VTAB 7 : FDR 1=1 TO B : PRINT -==*==-; : NEXT 

116B VTRB 23 : FDR 1=1 TO B : PRINT ' "; : NEXT 

1170 PRINT "Press spacaoar to see next record. 

1299 REM Gat records and display them on scrBBn. 
1218 FOR R.« TO NR 

1220 GOSUB 5008 : REM this loads «[N) uith record's data 
1230 REM The rest of this just displays ths data on the screen. 
1232 VTAB £ : POKE 1493,9 

1734 IF 5-9 THEN PRINT "Standard Values for thie File:" : 3CTS 1238 
1236 PRINT "Record ";R;* of "(NR;":"i CHR«(Z9) : REM chri(29) clears line 
1238 FDR N 1 9 TO NC-1 

VTAB TB(N.2)+1 : PDKE 14B3,TB(N,1] -1 
1242 PRINT CNS[TB(N,9)-1);-: -;CS(TB(N,0]-l)i CHRt[29) 

1250 NEX1 

1260 VTAB 24 : POKE 1403.37 : BET AI : PRINT AI; : REM ualt for kBy 
1278 NEXT 

1398 REM End game. 
1310 HOME : VTAB 12 . 

1320 PRINT "That's all the records in ";FS 
1330 PRINT 

1340 PRINT "Would you like to see annther? <Y/N> : GET AI : PRINT At : HOME 
1358 IF (M-*Y* OR AI-*y* THEN 1020 
1360 END 
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FroDOS 8, version L3, released to developers in mid-January and 

mentioned here last month, mistakenly includes a BRA (branch always) 
machine language instruction in a critical piece of code. This is a significant 
problem, because BRA isn't supported by the original 6502 microprocessor. 
Consequen tly, this version of FroDOS causes bad things to happen when run 
on Apple 11-Ftuses and unenhanced lies. If you BIX) AD PRODOS, TSYS, 
A$2000, then the bad instruction appears at $4CCD. A BEQ (branch on 
equal) would work just as well here, so you can fix things with a POKE 
19661240 and a BSAVE PRODOS, TSYS, A$2000. 

Another significant problem I've encountered while running the newer 
versions of ProDOS on earlier machines has to do with interrupts. ProDOS 
111 and earlier versions disabled interrupts. An alien static- or bad-luck- 
caused interrupt signal caused no problem with these versions of ProDOS 
unless some software that used interrupts had enabled them. Newer 
versions of ProDOS, on the other hand, leave interrupts enabled at all times 
in order to support some newfeatures of the Ilgs. If you use these versions on 
an earlier computer, an alien interrupt will lock It up with the message 
INSERT SYSTEM DISK AND RESTART' at the bottom of the screen. At least 
that's my diagnosis of why I've seen that maddening message more in the 
last month than in all my previous incarnations, I've reverted to using 
ProDOS ILL patched as described in our November issue, on everything 
around here except the Ilgs. 1 suggest you do so as well until further notice. 

The problems that Apple's SCSI card had with the Ilgs have been 
solved. There is a revision B EFROM now available for the card (part # 341- 
0112-B); contact your dealer for details. 

You might be surprised at the kind of things you can get on 
continuous forms. The advantage of continuous forms, of course, is that 
they are easy to process through any printer that has a tractor feed, which is 
just about any printer nowadays. Besides the continuous credit card forms 
mentioned in this month's main article, you can also get such things as 



mailing labels, envelopes, invoices, purchase orders, statements, letterhead 
stationery, checks, and even Rolodex cards on continuous forms. Spend a 
few minutes wandering aroundyour local office supply store to see what they 
have that you could use. Wouldn't life be easier if you designed a "labels 
style" report format for AppleWorks that could print your address-phone 
number data base on Rolodex cards? 

If you live in the U.S.. read this and act quickly. U,S. federal tax forms 
for 1986 are available on AppleWorks spreadsheet templates for $23.95 from 
Personal Financial Services, P.O. Box 1401. Melville, NY 11747 516-2618652; 
for $42.45 from Sky Computer Resources, P.O. Box 204, Portland OR 97207 
503-254-7291; or for $50 from Island Computer Services, 3501 E Yacht Dr, 
Long Beach, NC 28461 800-826-7146. All three packages include the main 
1040 form, as well as the forms for Employee Expenses, Depreciation, 
Itemized Deductions, Interest and Dividend Income, Profit from a Business 
or Profession, Capital Gains, Supplemental Income, Self-Employment Tax, 
and the Married Couple Deduction. All three packages produce IRS 
acceptable print-outs for all forms except those that are color-coded (the IRS 
does want you to use green-bar or lined paper, however). 

Personal's package, called 1040Works, also includes forms for Farm 
Income, Income Averaging, Credit for the Elderly, Sale of Residence, Child 
Care Expenses, Moving Expenses, 10-Year Income Averaging, and Alternative 
Minimum Tax. If you have enough memory for a 256K AppleWorks desktop, 
pay $3 more and ask for 1040Wbrks-X; youTl get all this stuff in one large 
spreadsheet 

Sky's disk also includes form 1040A and the schedule for Parm Income. 
Sky can provide any other form or schedule printed by the IRS for an 
additional $5 each. 

Island's disk also includes the forms for Child Care, Moving Expenses, 
Income Averaging and Credit for the Elderly, as well as tax planning 
templates for 1987. Island is the only company of the three that accepts 
credit cards. 

If you don't live in the U.S., (or Canada, Mexico, Australia, or New 
Zealand) read this. Because of a bad scale at our mailer's, our December 
issue, mailed near the end of November, went out with only enough airmail 
postage for 1/2 ounce. Since the newsletter actually weighed slightly more 
than that the U.S. Postal Service seems to have kindly forwarded that issue to 
you by surface mail. Except for that issue, we have paid fo r 1 ounce of airmail 
on each of your newsletters each month. If you have received any other 
issues by surface mail, or if you receive an issue by surface mail in the future, 
please send the empty envelope back to Sally Dwyer at our Overland Park 
address so she can figure out where our intentions have gone astray. 
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Ask 

(or tell) 

Uncle 



Man talks, Apple listens 

I was sick of reading how wonderful your newsletter 
is in all the computer magazines. 

( was sick of getting little notices in all my new 
Beagle Brothers software telling me you were still 
alive. 

1 was sick of getting postcards in the mail asking 
me for a good reason not to subscribe to Open- 
Apple, 

So I took you up on your offer of a free issue. And 
now, damn it, I'm a member of the insidious "Gee, 
one suggestion alone was worth the entire cost of the 
subscription" club. 

Ok, enough of that Let me tell you what I'm doing 
with my Apple lie At the very least, I'd like to leam 
what others might be doing in a similar vein. 

I'm the statistician for a group of baseball fanatics 
in what we call the Duckball League. (About the name, 
well, ifs a long story.) Anyway, we draft major league 
players onto our teams and compete with each other 
in a number of statistical categories. And since I'm 
the one with the computer, I'm the statistician, Funny 
how things work out that way. 

I use AppleWorks and about a 74K spreadsheet to 
keep track of everything, normally, it takes me about 
two hours a week to enter the data on the almost 300 
players in the league. The most difficult part is 
looking back and forth from the tiny type in USA 
TODAY (our bibl e ! , to the keyboard, to the screen, and 
back again. I figured I could speed things up by 
eliminating one of those three elements. Enter voice 
recognition. 

After checking the few manufacturers of Apple 
voice recognition systems 1 could End, I decided on 
Intravoice 11 from the Voice Connection in Irvine, 
California It consists of a main plug-in circuit board, 
a microphone, and a couple of smaller boards into 
which you plug several of the Apple lie's ICs. All in all 
it's pretty easy to instalL 

The voice input module itself is quite easy to use 
and can be trained to recognize just about any word. 
That word can then be used to as a substitute for any 
keystroke or string. Itsupports open- and solid-apple 
commands as well, so ifs ideal for my use in entering 
Duckball stats into the AppleWorks spreadsheet 

I have encountered one and only one problem in 
my entire use of Intravoice II to date. When using a 
phrase ("Pinpoint") to substitute for a so!id-apple-P 



AppleWorks crashes into the monitor. I'm talking 
dead. Once I'm in PinPoint voiced solid-apple com- 
mands work fine. But somehow when AppleWorks is 

active it doesn'twork. ''«,»■, 

RexCreekmur 

Qrand Rapids, Mich. 



your fetter leaves me speechless. The address of 
The Voice Connection is 17835 Sky Park Circle, Suite 
C, Irvine, CA 92714, (714) 261-2366. 

The elusiveness of relative power 

In Computers Apple Applications Vol. 4 (Call/ 
Winter 1386), William Mensch, the one-man 65816 
progenitor, states that the 65816 (and presumably 
the 6502) runs in such a manner that one of its bus 
cycles is equal to four of anybody else's (page 18). He 
states that a 65816 running at 6 megahertz is 
"equivalent to the IBM PC running at 24 megahertz" 
and "a 2- to 3- megahertz Apple has the same kind of 
performance as an 8 megahertz Macintosh." 

This information, if correct is of critical importance 
to a typical hobbyist, such as myself, readyfbr his next 
generation computer. The marketing power of this 
alleged fact is exponential Many times in the last 
three years I have pondered to myself something like, 
"My He is a wonderful machine but 1 wish I had the 
speed and power of the 8088". 

It seems to me that the 6502's longevity and the 
allegiance it commands may be due as much to its 
unsung power and speed as to marketing forces over 
the past ten years. Maybe it's not ancient and obsolete 
but instead wasahead of its time when created and is 
still incredibly capable in its present form. If this 
conjecture has some credibility, then it follows that 
even though the 65816 is panned by blue loyalists as 
a 16-bit introduction at the dawn of a 32-bit era, the 
brute-force power and sophisticated characteristics 
may well approximate, parallel, or even outshine the 
favored sons of Mac and Charlie. Regardless, the 
technology for building a San Francisco skyscraper is 
quite different than that for building the Golden Gate 
Bridge. Both are indispensable. 

Steve Cranney 
Fallon, N.Y, 

Microprocessors are complex devices. Just as you 
can control the superiority of quarter-horses over 
Thoroughbreds by shortening the race, microcom- 
puter loyalists can devise benchmarks that show 
their favorite microprocessor is the "most powerful" 
That's why the benchmarks we published here 
(December 1386, page 2.88) were the standard 
benchmarks Byte has been using for years— we 
didn't u>anf to be accused of favoritism. Yet that's not 
to say we would have been so eager to publish the 
results if the 6502 and Its progeny hadn't come out 
looking so good. 



by the way, congratulations to Compute!) are based 
on the fact that the 65xxx series uses ascheme called 
"pipelining" that allows it to grafj the next piece of 
data it will need while it's still working on the last 
p ie ce and on the fad that all instruct ton codes in the 
eswctseries are just one byte long. This places some 
limits on the number of different instructions but 
allows faster execution. 
The general philosophy of the 6Sxxx series Is that 

supposed to do and more time actua% doing it This 
translates into faster execution of common tasks at 
the expense of the inclusion of more powerful 
commands, such as multiply or divide instructions. 
This same philosophy has been used to develop a 
new breed of "reduced instruction set" computers 
that actually execute only a few instructions but do 
so very quickly. ThelBMPC-KTisan example of this 
kind of machine. 



In a practical example, the 65816 is faster than a 
68000 (at the same clock rate) for simple load 
accumulator and save accumulator operations, which 
would favor the 65816 in a benchmark based on that 
ability. The 68000 should kill the 65816 in a math 
benchmark, however, because the 68000 has math 
instructions that the simpler 65816 instruction set 
does not JYonetheiess, if a benchmark doesn't use 
the 68000's math operations and instead does math 
"manually" as the 65816 does, men the comparison 
would favor the 65816. 1 suspect this is essentially 
what happened with the Byte benchmarks we 
reported. 

Dennis recommends you take a look at the series 
of books Adam Osborne has written on microcompu- 
ters for further information. 

In the final analysis, the most important thing to a 
hobbyist shouidn't be a microprocessor's power, 
anyhow You should be looking for a computer with a 
good, reliable, overall design, with good software 
that does the kinds of things you want to do, and 
with good documentation (very important, but often 
overlooked). An example of the importance of docu- 
mentation is the first commercially available l&bit 
microcomputer, the Texas Instruments 99/4. Tl 
wanted to develop all the software for the machine 
itself and locked hackers out. Mo documentation no 
hacking,- no hacking, no programs; no programs, no 
customers. What was the advantage of owning the 
most "powerful" microcomputer of its day if you 
couldn't figure out how to do anything interesting 

RGB and TV too 

1 have a Sony KV-1311CR monitor hooked to my 
Apple Ilgs. ifs a 13-inch, cable-ready, remote-control 
TV, with analog and digital RGB inputs and video 
inputs and outputs. It has a dandy picture, both in 
normal TV use, and when used with the GS analog 
output KV-1131S can be had mail order for less than 
the Apple monitor (the latest price I've seen is $399). 1 
also like it because I can hook up the GS to the analog 
input a ll-Plus to the video input and cable TV to that 
input, and have them all there for use in one neat little 
package.. 

The pinouts in the Sony book are as if you are 
looking at the mating cable connector, not at the jack 
on the TV. On the monitor, pin 1 is at the bottom, 
towards the back. On the Ilgs, pin 1 is on the top, 
towards the on-off switch. Incidentally, the numbers 
don't match the pin numbers molded on DM5s, or 
at least not on the one 1 used Here's how to run the 



wires: 
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Function 


Pin 


Pin 
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Red Ground 


2$ 
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Red Signal 


2E 
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Green Signal 


10 
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Green Ground 


17 


3 


Blue Signal 


12 


13 


SIue Ground 


3J 


3 


Composite Sync 



You can also enable the Ilgs audio output, but this 
is less straightforward. The Sony requires +2,5 to 5 
volts on pin 34 to enable the audio input Otherwise, 
you'll getTVaudio all the time . Apple neglected to put 
+5 volts on its jack. However, there is +12 volts. You 
can have a technician build you a vottage divider out 
of a couple of resistors to cut back the +12 volts, 
which comes out of pin 8 on the Ilgs. The audio signal 
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comes out of pin 11 on the Ilgs and goes into pin 24 
on the Sony. 

An alternate option is to use the.voltage divider to 
automatically switch on the video RGB when you turn 
on your computer. To do this, hook the +5 volts to pin 
33 on the Sony. Chris Amdt 

So, you can get a "free TV" by carefully selecting a 
llgs monitor. The March 1987 issue of Consumer 
Reports compares 1 75 color television sets from 21 
different companies; nine of these sets reportedly 
have ROB inputs. The nine are J.C. Penney model 
2220, Magnauox models RE 4254HW and RQ43 785ft 
Quasar models TT6290XE and 7T6298W, Sanyo 
models AVM210 and 12C700, Sears model 42701 
and Sony model KV-20XBR. There are, no doubt, 
others— the set you haiie, for example, isn't among 
the 175 sets listed. 

Slashed zeros and 8 bits 

I have spent many hours trying to get my 1 magewriter 
[I to print slashed zeros. I've tried using the control 
codes given in the manual; it works line except that I 
get a double-spared printout. 

As 1 read the printer manual, the printer codes 
required for slashed zeros are: 

Slash on: ESC D Control-S ContrDl-fl 
Slash off: CSC Z Control-e Control-fl 

What am I doing wrong? 

Richard E. Breininger 
FPO Miami, Fla. 

ESC D and ESC Z allow you to change the Image- 
writer dipsuntch settings under software control ESC 
D is used to turn switches on. ESC Z is used to turn 
switches off. There are two eight-switch groups of 
switches, called A and B, for a total of 16 switches. 

Afterthe ESC D or ESCZthe/magewriter expects to 
see 16 bits of data that tell it which switches to turn 
on or turn off. Apple's sequence for turning on the 
dipswitch for stashed zeros is (hex values) "IB 44 00 
01". This causes switch 1 on dipswitch B to be turned 
on. This tells the Imagewriter to use slashed zeros 
and slashed zeros we have, 

Unfortunately. however, Applesoft lakes the liberty 
of setting the high bit of each byte printed (for a 
complete discussion of this problem see "Control- 
D(efeated)" in our December 1986 issue, pages 2.84- 
86 and "A bit too many" in April 1966, page 2.24). 
Thus, the actual values sent are "96 C4 80 81" 
Consequently, lie actually turn on two additional 
switches— switch B-8, which is not used by the 
printer (no problem) and switch A-8, which adds a 
linefeed after carriage return if it is on (Presto! Instant 
double-spacing). 

One answer is not to send the command sequence 
through Applesoft— see our December issue for the 
details. In this case, however, we don't have to get so 
elaborate. We can just turn the linefeed option back 
off after turning slashed zeros on. In other words, 
after sending the codes ESC D control* contrcA-A 
also send ESC Z control* control-*. Your printer will 
see "96 C4 80 81 9/5 DA 80 80" and will begin giving 
you slashed zeros without extra linefeeds. 

Here's agood tip for those of you having problems 
similar to this one— it comes from a letter in our Hay 
1985 issue, page 39. Turn your Imagewriter off, 
press and hold down on the linefeed button, and turn 
it back on. It will now print the hexadecimal code for 
each character It recedes instead of doing normal 
printing. This feature can be quite useful for diagnosing 
printer command-code problems. 



PRINT TAB alternatives 

Tell me how to get a PRINT TAB statement to look 
like it does on your Apple He screen when you're 
printing to an Imagewriter II. Help -I'm a desperate 
woman! 

Robin Boscia 
PHteburg,Penn. 

1 have a problem with an Imagewriter II, Super 
Serial Card, and enhanced lie my Applesoft program 
has tabs and the printer will not go to the correct 
columns. Tabs range from column 1 to column 103. 
Can you help? 

David E. Brewer 
Cincinnati, Ohio 

Amazing. I've spent all morning playing with 
PRINT TAB on an enhanced lie with a Super Serial 
Card and it hardly does anything right. After trying 
all kinds of combinations, Including printing with the 
screen display in 40 and 80 columns and printing 
with video echoonand off (contrail I), I finally found 
a combination that worked: before turning on your 
printer, PRINT Ct1R$(21) to the screen to turn the 
Apple 80-column firmware off. Then, after turning 
the printer on PRINT CtiR$(9h"T E" (space required 
between T and E) to enable the Super Serial Card's 
"Basic Tab" command, whichl don t remember ever 
hearing of before this morning's search through 
instruction manuals. That anyhow, made this program 
work (using ProDOS): 

IB HDriE : PRINT CH«(21) : RE- y „-r off B0-CDlumns 

29 PRINT CHRI(1);-PRIir 

25 PSINT CHM(9);*T r : REM Turn on "Basic Tabs" 

30 FDR 1=1 TD B : PRINT 5PC(9):T: : NEXT. : PRINT 

40 FDR [-1 TD 6 : PRINT "1234567B90-; : NEXT : PRINT 
50 FOR 1=1 TD 4 

60 PRINT TPiB [ 3tS J : "HOW-: TMHei ; -cub- ; TfiB t Sfl ) ; "UHD- 
70 NEXT 

80 PRINT CHf»(4|;*PR83* 
EZ END 

A significant problem with this trick is that the 
Apple lie serial port command set doesn't include 
the "control-/ TE" command. 

Using PRINT TAB while both the SOcoiumn/irmuBre 
and the printer are turned on doesn't work at all This 
is because something, probably the firmware but 
I'm not sure what forces the values In Cfi (byte 36 or 
$24) and OURCH (byte 1405 or $57B) to zero, CH 
holds the horizontal cursor position for 40-co!umn 
firmware and OURCri the position under 80-columns. 

But Applesoft expects these locations to also 
reflect the horizontal position of the printer. Vet when 
both the printer and 80-column mode are on, both 
bytes always hold zeros (that's why an initial PRINT 
145 works fine but later ones work just like PRINT 
SPC). Any readers who can provide more information 
on what the bug is orhow to make TAB work right are 
encouraged to write. 

Meanwhile, here are two ways to do tabbing 
without using PRIM TAB. Let s say you want to print 
a table in three columns. Assume the widths of the 
columns are stored in the variable array CW(c). The 
stuff you want to print in the columns is stored in the 
variable array Tt(r,c). In this case, try the following: 

IB FOR R»l TO NR : REh Fpr rou 1 through It of rows 
20 FOR C-l TD NC : REH For col 1 through B of cols 
30 C*=LCFTt[Ti[R,C),CH(C)) = "EN truncate 
40 PRINT Gt; SPC[CU[C)-LEN(C»)): 
SB NEXT : PRINT 
G0 NEXT 



Jn line 40 we print the data, then use the PRINTSPC 
function to /ill out the column with spaces. Vie 
determine how many spaces to print by subtracting 
the length of the stiingjust printed fromthe column's 
width To use this trick we have to make sure the data 
isnever wider than the column. If His, the subtraction 
will produce a negative number and the program 
will stop with an ILLEGAL QUANTITY ERROR in the 
SPCfunctlon. Thai's why line 30 truncates everything 
to the width of the column. The biggest disadvantage 
of this method Is that all these string manipulations 
will slow your program down— you may find your 
printer Is waiting on the computer rather than the 
other way around. 

The second alternative islouseyourprinter's tabs. 
This presents two problems, first, you have to figure 
out how to set the tab stops. Then you have to figure 
out how to get the control character, which most 
printers use for a TAB command, through your 
interface card and out to the printer. 

For the Imagewriter, the command sequence "ESC 
CttSs the printer you are sending a list of tab stops. 
This list comes Immediately after the command and 
is a sequence of three-digit numbers, separated by 
commas and terminated with a period, The numbers 
will be sent as ASCII characters, so we don't have the 
high bit problem mentioned in the last tetter. To set 
tabs at columns 30, 40 and 50, for example, use 
PRINT CtiR$(27) ; "(030,040,050: (ff you're having 
trouble with the conversions of things such as ESC 
into things such as CtiR$(27). just memorize the 
"ASCII Control Code Rosetta Stone" on page 85 of 
the November 1985 Open-Apple. ) 

The /magewriter also auows you to clear a list of 
tab stops-Just use "ESC )" instead of "ESC (". You 
can clear all tab stops with "ESC ". tWien setting 
tabs, the left-most print position is tab stop 1. The 
maximum pe rmitted setting depends on the width of 
the character set you are using. Once you have set a 
tab stop, however, it remains In the same absolute 
position on the page, (at least with the Imagewriter) 
even if you change character widths or the position 
of the left margin. 

There are two ways to sneak a control-l through an 
Interface card. You have to sneak them through 
because most cards use control-/ as a "wake-up, 
here comes an Interface card command" code. 
Consequently the cards eat any control-Is they see 
rather than passing them on to the printer. Some 
cards. Including the Super Serial Card, will pass a 
single control-l onto your printer if you print two of 
them in succession. Otherwise, you hane to change 
the card's command code to something other than 
control-l. Do this by sending a control-l followed by 
any other control-character. If you do this, however, 
change the command code back to control-/ before 
you turn the printer off. 

Try this program to see how an Imagewriter 
handles tabs with your interface card: 

10 PRINT tHH*i4];-pB«l- 

15 PSINT CHRS[27);"9'; : REM clnr all tab stops 
28 PRINT CHRf[27; ; - 1030, 040. 0S0.-; 
3D FOB 1-1 TO 6 : PRTNT 5PC(9);I: : NEXT : PRINT 
40 FOR 1=1 TO 6 : PRINT -12345G7B98-; ; NEXT : PRINT 

50 TFJ*-CHRI(9] : ZI=CHR»(2fi) 

52 PRTNT TtW;ZI I REP1 Changs cad code to ctrl-Z 

54 EOSUB 90 

55 PRINT CHr»(2?};"L020";"Laft margin at col 

sa go-sub 9» 

£0 PRINT CHRl[27);*Lwe-;-LBft margin at col 0. 

62 PRINT CHR5[27);"P-;-Proportiqnal type" 

64 G05UB 90 
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66 PRINT CHRt(27);'Q~;-17 chars par Inch." 
6Q GDSUB 90 

70 PRINT Zi;TBI : PRINT "TRS uith tuo ctrl-ls,' 

72 TBt=TBI*TBj 
74 SGSJB 98 

B9 PRINT CHHl[4);-PRIt3" 
B2 END 

90 FOR 1=1 TD 1 

92 PRINT TBirNice-;TBS;"CDlumns,":TBS;"right?" 
34 NEXT : PRINT : RETURN 

GET out of text files 

1 have been working on a program that creates 
downloadable characters for my Imagewriter printer. 
I had it save the characters in a text file. When 1 tried to 
read the data back I discovered something unusual. 
My read routine was similar to this: 

10 GET M 

20 B = fiSC («) 

30 GOTO 10 

If you type this in and run it, it works fine most ofthe 
time. The problem arises when you try to read a $O0 
(or $60 as it is stored tn the file). If you try control-® in 
the above program you get an ILLEGAL QUAHTrTY 
ERROR in line 20. Any idea why? Can I make it quit 



Steve Carrier 
Liberty, Mo. 

GET will not read an ASCff $00 or $80 (control-®) 
character; it interprets it as a nuil string. The GET 
does return to your program, however, so here's 
how to detect anASClI$00: 



10 get fa 

IS IF LEN(fl$J = 
20 fl - BSC (AS) 
30 GOTO IB 



THEN fl = i : GOTO 30 



tfonetheJess, a text file is probably not the best 



the high bit. Try POKEing your characters into a 
buffer and BSAVZing them. Or, if you insist on a text 
file, convert the characters to ASCII numbers while 
saving them with PRINT STR$(A) and read them back 
with IHPUTA$ :A=VAUA$). This willprobabty quadru- 
ple the size of your /He, hou>ener. 

MuHiplan to DIF 

In regard to the question in your November 1986 
issue (page 279) about converting Muiriplan files to 
Sup erCalc files, a recent issue of Computet includes 
a program by D.W Walkey that converts Muftiplan's 
SYIA files to DIF files (issue #37, page 20). I've used 
the program to move several spreadsheets to 
AppleWorks. j. D .Holdeman 

fl. Ridgeville,Ohio 

Computfcf's address is P.O. Box 110846, Tacoma, 
WA 98411 DIP fV.es, of course, will move only the 
values from one spreadsheet to another, not the 
underlying formulas. 

Editing data files 

In your November 1386 issue (page 2.77), Lawrence 
Pratt mentions that he edits programs and data files, 
even random access files, with Apple HHter. Can you 
give more in formation about how this is done? Is this 
a better method than using QFLE or simply a different 
way of doing the same thing? 

Thomas E. Militello 
Rancho Falos Verdes, Calif. 



Everyone has his orher/auorite method of writing 
programs. GPLE and similar programs are "line- 
oriented" editors— you edit one line at a time. Many 
of us who are addicted to "screen-oriented" word 
processors, however, keep whatweknow about line- 
oriented editors and ox-drawn vehicles on the same 
indexcard. 

Tb use a uiord processor to write programs, simply 
make sure you enter a return at the end of each line. 
Saue the program in a text pie (from AppieWfarfcs, 
open-appie-FfrintJ the program to "A text (ASCII) fUe 
ondisk.") Exit your word processor, enter Applesoft, 
and EXEC the text file you have written. Uncle DOS 
wilt type your program in for you. For more on this, 
including how to get programs you have already 
written into text files you can edit see the Nay 1985 
Open-Apple, page 36. 

If you happen to use Apple Writer for program 
editing, CondiCom's program OpenAppleWriter is 
very handy (December, page 2.87). Another possibility 
is Program Writer from the Software Touch (Sep 
tember, page 2. 62c), which is a full-powered, screen- 
oriented program editor. 

Using a word processor to edit data files is simifar 
to editing program files. In order to edit random- 
access files, however, the file should be completely 
filled with blanks or other characters before being 
used the first time. For much more information on 
ihissubject, see my column in theMay 1984SofWk, 
page 164. 

Only exit FOR-NEXT at NEXT 

The insertion sorts printed inyour November 1986 
issue (page 2.80) had a common erroneous method 
of exiting a FOR— NEXT loop. 

It should read: 



first routine: 
9<I8 IF fl(E) <= T THEN E=£I 



3y: sse 



second routine: 
9S0 IF A[K.DS([E) ) <= fi[K,T) THEN E=E1 : GOTO 9SS 

Before you exit a FOR— MEXT loop, you need to 
close out Applesoft's handling of that loop to free up 
the stack- The amended lines will set the loops' index 
variables to their maximum values and GOTO the 
loops' NEXT statements, so that Applesoft will close 
out the stack handling for the FOR— MEXT before 

cont ' nuin9 ' CraigWillford 



Vou are correct. / talked about this problem in the 
April 1984 Softalk, page 52. Using GOTO from 
inside a FOR—tlEXT loop to a iine outside the loop 
ieaues Appieso/r expecting a NEXT that never comes. 
Exit like this from eleven loops mith different index 
variables in a row and you il ge t an OUT OF MEMORY 
error. Applesoft won't say so, but it means it's out of 
stack memory. 

As a practical matter, many programmers use the 
same index uariaMe for aii (oops, so they rareiu see 
the bug. Applesoft fixes the stack automatically 
when a loop, or any other loop that uses the same 
Index uariabie (E in this case), is re-executed, none- 
theless, there isa limited amount of stack memory in 
theAppleII(256 bytes), consequently programmers 
should try to keep it free of muck such as unresowed 
FOR—T1EXT loops. 

More TransWarp experiences 

I read with interest the letter from Fat Marnett in 
your January issue, page 2.96, with reference to 



problems with a TransWarp board. I used an Ace 1000 
with a TransWarp and Feachtree's Back to Basics 
accounting package with no problems. Recently, 1 
upgraded!?) to the Ace 2100. Upgrading my Bade to 
Basics program to the II e configuration and using the 
TransWarp, 1 lose all data on the second drive. 
Removing the TransWarp, everything is perfect Thank 
the 1.ord 1 copy data regularly! I've called AE before 
about the TransWarp and came away feeling like a 
stupid ass from the condescending atrJtude : i don't 
think the ProDOS patch would work because Bacfc to 
Basics is a DOS 3 2 program, so my TransWarp is 
sitting on the shelf. 

Frank Drew 
Seminole, Fla. 

I have been reading your letters about ProDOS 
zapping disks. Although I never experienced that, 1 
have experienced three zaps of some significance to 
me and I wonder whether you have heard of similar 
complaints. 

Briefly, 1 have zapped three disks when I tried to 
disable my TransWarp, using the escape key, after 
power-up. The three disks were all copy-protected 
and non-ProDOS-the reading program Smut Eyes, 
a Moebius scenario disk, and a program called 
WfcroTest from flarper and Row that 1 use in my 
sociology class. 

My computer has Pinpoints He upgrade kit and a 
Checkmate 768K memory board. 

Larry Davis 
Bedford, Texas 

We'ue received a couple of other letters reporting 
problems with TransWaipssince publishing Mamett's 
letter. My own He even started acting flakey last 
week (spreadsheet cells in columns to the right of 
my work area having nonsense formulas tn them, 
characters / hadn't entered appearing in unusual 
piaces on the screen, computer locking up) and all 
the problems went away when I replaced my Trans- 
Warp with an older SpeedDemon. 

The big problem, of course, is that once you're 
used to working with a TransVlarp, it is very difficult 
to go back to something that's slower. Another 
difficulty is that the problems come and go— Dennis 
put my TransWarp in his He and hasn't had a bit of 
trouble. 

I suspect the root problem is that the TransH&rp 
pushes the He hardware to its limits. My guess is that 
meafc chips or noise In the computer, rather than in 
the TransWarp, are causing most of these problems. 
Another potential culprit is dirty contacts on the 
TransHfcrp's edge connector. These are Just guesses, 
however. 

RAM, compiler comparisons 

I recently called Applied Engineering and ordered 



so 1 could compare it with the software that came with 
my Checkmate MulrJRAM CX card (for the Apple 11c). 
As far as 1 can tell there does not seem to be any 
problem running Applied Engineering's $10 software 
With Checkmate's card, except for the AppleWorks 
Desktop Expander itself, which doesn't work. 

Other comparisons between (he two disks have left 
me favoring Checkmate's $5 software. Checkmate's 
RAMdisk, called /MRAM, is configured for slot 3 drive 1 
and leaves / RAM in slot 3 drive 2 intact AE's RAMdisk, 
on the other hand, expands the the size of /RAM in 
sIot3 drive 2. 1 prefer Checkmate's way of creating the 
RAMdisk with a SYS file rather than a file that must be 
run from an Applesoft program as with AE's software, 
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AE's disk did havea nice program that usesauxiliary 
memory for a a one-pass disk copy (5.25 disks only). I 
don't see any advantage to using it, though — since it 
must first format the disk it is going to use it isn't any 
faster than Copy U Plus. Both disks nave very similar 
auto-load programs for moving files to the RAMdisk. I 
did not compare (he two except to notice that both 
seem very easy to customize. I always use MouseDesk s 
auto-load feature so I don't need another auto-load 
program. 

1 have two compiler bugs to report Interestingly 
enough, they were both discovered while using.two 
different compilers on the same program and both 
problems were similar enough to affect the same 
program line. 

The first one is in the Beagie Compiierfversion 10) 
and is illustrated in the following example: 

IB D - 23: CI = STRt(D) : OK = VflL(D$): PRINT DX 

The above statement will print 23 with Applesoft 



BASIC (version 2.2) and can be demonstrated as 
follows: 

IB Df = * 9": D* = VflL(DJ): PRINT D* 

This statement will print 9 with Applesoft and print 
1024 with WicolMS/C 

I've sent letters to each company and I would 
expect they will implement fixes shortly. The Wicol 
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BASIC bug can be worked around as follows: 

19 EH = * 9"; = VRL(W): Ot ' D: PRINT 0% 

Anyone who uses the PlnPolntDesktopAccessories 
may want to remove some accessories from the list or 
rearrange them. This can be done by loading the text 
file PinFOIMTFROFlLE from the install disk; then 
arrange the file the wayyou want it; then save the file 
back to the disk and run the install program. You may 
even be abie to install your own favorite 



it to the list along with its length and highest memory 

addrcsSi David Stevens 

Eden Prairie, Minn. 

Our experience and a grouting piie of letters from 
our subscribers indicate Checkmate also has much 
better technical support 

The Beagle Compiler is up to version 2,0. tn 
addition to a fix for the STR$ bug, the latest version 
lets you automaftcaiiy store strings and arrays 
outside of main memory. This gives you more room 
for programs and much more room for data The 
extra memory supported includes the second 64K 
bank of a 128K lie, a f/c or a Ilgs; auxiliary slot RAM 
cards fromApplied Engineering and Checkmate; and 
slot 1-7 memory cards fwm Apple, Applied Engineer- 
ing, and Cirtech. 

Memory, Apple Writer gotchas 

In your discussion of the various kinds of RAM in 
the December 1986 issue, you said "interestingly, 
none of these switches (HIRES/LORES, STORE40/ 
5TORE80, PAGE1/PAGE2) actually do anything to the 
current display that appears on your monitor." Well, 
thafs almost true. If text or graphics page 1 is already 
being displayed, then turning on STORE80 will not 
change the display. But if page 2 is being displayed, 
turning on STORE80 will change the display to page 1 
as the PAQE1/PAOE2 switch takes on its new meaning. 

On the older unenhanced Apple lie, this little 
interaction can cause a minor display annoyance in 
certain programs — specifically programs that display 
text on hi-res graphics page 2 and rely on monitor 
routines to help with the text bookkeeping. This is 
because a few monitor routines in the unenhanced 
He, including the scroll routine, turn on STORE80 for 
a brief moment even with 40tolumn operations. 
While STORE80 is on, the display changes to graphics 
page X causing a brief "flicker" on the screen. The 
enhanced He and lie do not access 5TORE80 during 
4(Kolumn screen operations and so do not have this 
problem. 

You suggest that the "best" use of the auxiliary 
bank 64K of memory or an auxiliary slot memory 
board is as a RAMdisk. Do you mean from an applica- 
tion programmer' s point of view or a user" s ? As a user, 
I find both the built-in ProDOS RAMdisk and the third- 
party auxiliary-slot memory board RAMdisks less 
than convenient to use. Sometimes the most conve- 
nient way, or in some cases the only way, to get from 
one applications program to another is to press 
conrrol/open-apple/resetto reboot But the contents 
of these auxiliary memory RAMdisksare lostwhenever 
you reboot You have to be careful to use any Quit 
options provided when moving from program to 
program. 

In addition, for the auxiliary-slot memory boards, 
you have to run a special program every rimeyou start 
up in order to "install" the RAMdisk driver code into 
memory. I've talked to too many customers who 
believe that they should be able to cold-boot any 



recognize their auxiliary slot memory board as a 
RAMdisk. Since their memory board works so well 
with AppleWforks, they believe there's a bug in any 
program that can't do that 

You mention in the article that Appie Writer doesn't 
follow the documented protocol for disconnecting 
the auxiliary memory RAMdisk. Here's another inter- 
esting and obscure little tidbit -Apple ttriter also 
diddles in silly ways with the Super Serial Card. 

The printing set-up file that com&s with Appie 
Writer includes the setting "CR1", which means 
Apple Writer will supply its own linefeed character 
after each carriage return. But the printer cards on 
most Apples are already set to supply their own 
linefeed after carriage return. They need to be set that 
way for printing from Applesoft to work. 

So how does Apple KHteravoid double spacing? It 
first checks if the printer interface is either a Super 
Serial Card or a 11c printer port If it is, Apple Writer 



for the printer interface to turn off the interface card's 
linefeed. Now^pple Writer can add its own linefeeds, 
and every SSC or lie owner is happy. 

Well, almost... Appie Writer doesn't repoke the old 
values back into the screenholes and the Super Serial 
Card doesn't forget previous pokes unless reset is 
pressed. The other day I printed a document using 
Apple Writer, then used "control-QJ" to exit "gracefully.'' 
I switched to another ProDOS program (never needing 
to press reset), then tried printing something out to 
the printer from this program. The printer did not 
advance the paper. Line after line was printed one on 
top of another, since the Super Serial Card would not 
Issue linefeed characters after carriage returns. The 
change that jlppie Writer had made was soil in effect 
Remembering these problems, I pressed control- 
reset to force the Super Serial Card to reinitialize 
itself, then printed again. This time it worked fine. 

Phil Thompson 
Portland, Ore. 

So that's why my spelling checker prints differently 
every time f use it Apple Is always harping at 
developers to put everything back just like they 
found it (no problem here, I agree with them), but 
Apple's own software is as bad as any at not following 
the rules. 

The ProDOS quit feature, combined with program 
selection software, has created a trend toward not 
rebooting machines between applications. Thus, it is 
becoming more ant? more important that each 
application program undo any changes it makes to a 
computer or its attached deuices. 

My comments about it being "best" to use large 
memory cards as RAMdisks were aimed at both 
programmers and users. It's true, however, that a 
significant problem with the auxiliary-slot cards is 
that the software that makes them work must be 
Installed" every time the user reboots, However, 
neither Applied Engineering's nor Checkmate's aux- 
slot RAMdisks wiU lose their contents during a reboot 
as long as bank is locked out. I'm still (oofcingfor a 
universal licensable RAM disk driver that would 
recognize any type of RAM and conuert it all into a 
large RAMdisk if no other driver was already installed. 
Commercial developers could include such a d river 
within their software to make memory management 



opens, of course, is that all RAM cards (to say noth ing 
of hard disks and whatever storage deuices the 
future holdsj loo* and act alike, ei>en though they are 
in reality quite different 



